home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
xstat140.zip
/
XFERSTAT.DOC
< prev
next >
Wrap
Text File
|
1992-08-07
|
11KB
|
340 lines
─┐╓ ╓── ╥─╖ ╥─╖ ╓─╖ ─╥─ ╓─╖ ─╥─ ╓─╖
╓┼╜ ╟─ ╟─ ╟┬╜ ╙─╖ ║ ╟─╢ ║ ╙─╖
╜└─ ╨ ╨─╜ ╨ \ ╙─╜ ╨ ╜ ╙ ╨ ╙─╜
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Release 1.40
Download Log Scanning and
User's Statistics Door For PCB14.x
by: Keith Cochran
SysOp, Paradox BBS (302) 645-7264
Entire Work, Including Documention is
Copyrighted by Keith N. Cochran. (c) 1992
What is XferStats ?
-------------------
XferStats was born out a need for a small utility to allow users
and the SysOp to scan PCBoard's DOWNLOAD.TXT file for a listing of
files they have transferred. Sam Smith's ProWho door allowed this,
but many users did not like the idea that other users could do a
scan on THEIR name too. This is especially true if your BBS contains
adult or other "sensitive" type files.
About a month ago, I came across just such a door program. But it
was so severely crippled and poorly written that I was embarrassed
to even put it up publicly. So I said "what the hell, I'll write my
own version". So please keep in mind that this is my first attempt
at writting a full blown door program.
I'd like to take this oppurtunity to thank Sam Smith for his wonderful
ProKit libraries, without which; many, many door programs would have
never been written.
Features
--------
Simple to setup. Zero maintenance.
Support for both PCBoard & ProDoor BBS types. (Some features require
PCBoard 14.5+)
Maybe be run as a PCBoard "SHELL" door. XferStats is 100% seamless
when registered and run in SHELL mode. Filename to get File Stats
for may be passed from PCBoard 14.5's command line.
Allows a caller to list what files he/she has transferred to/from
the BBS with a nicely formatted, colorized display.
Allows a caller to create a list of what files he/she has transferred
to/from the BBS, that they can then download.
Allows the caller to view his/her's personal statistics.
Allows the caller to find out when a file was uploaded, how many
times it has been downloaded, and when it was last downloaded.
If the caller has SysOp security, he/she will also be shown who
uploaded the file.
Files associated with the door's operation:
-------------------------------------------
XFERSTAT.EXE : The main program.
XFERSTAT.DOC : You're looking at it.
XFERSTAT.CNF : The configuration file (explained below).
XF.CNF : Alternate configuration file (SHELL Mode)
XFERSTAT.DAT : The protocol translation file (explained below).
XFERSTAT.HST : History of changes made.
XFERSTAT.HLP : Help file.
XFERSTAT : Sample Door batch file
XF : Sample Door batch file (SHELL Mode)
XFMENU : User Menu.
XFMENUS : SysOp's menu.
XCLOSE : Closing file displayed when run in Non-Shell mode. (Opt)
Setup:
------
UnZip the contents of the zip file into a directory of your choosing.
Edit the XFERSTAT.CNF & XFERSTAT.DAT files as outlined below.
>>>>> In order for the List & D/L functions to operate, both <<<<<
>>>>> PKZIP.EXE & DSZ.COM must be available via the PATH. <<<<<
**** N O T E : The Create List and D/L Functions Are DISABLED ****
**** When Running In The PCBoard SHELL Mode !!!!! ****
The XFERSTAT.CFG file:
----------------------
INTERRUPT
C:\PCB\MAIN\DOWNLOAD.TXT
XCLOSE
BBS NAME
0
120
YES
YES
Line 1. Interface type. Standard for ProKit.
Line 2. Path AND Name of DOWNLOAD.TXT file.
Line 3. Optional Closing file. (Not displayed in SHELL mode)
Line 4. BBS name (Displayed in registered versions only)
Line 5. Registration # (0 if unregistered)
Line 6. Minimum security level to use SysOp functions.
Line 7. Whether Door is being run as a SHELL program. YES/NO
This is important, as it's disables the Create List function
do to memory constraints when operating as a SHELL door.
It also disables the display of the closing message and
the closing file when in SHELL mode for a truly seamless
look. (When registered).
LINE 8. Whether entries should be written to the CALLERx file. YES/NO
These include what the caller scanned for, if they downloaded
a list, etc.
The XFERSTAT.DAT file:
----------------------
This file simply contains the protocol letter used by PCB and a name
that you wish the letter to be tranlated to when displayed.
This file is optional, but is HIGHLY RECOMMENDED.
A sample XFERSTAT.DAT is included in the ZipFile. It may contain
up to 19 translations (2 lines each). Each translation to be used
may contain up to 7 letters. The format is as follows:
Z
Zmodem
Y
Ymodem
G
YmodemG
H
HS/Link
M
MPT
N
None
...
etc...
Door Batch File:
----------------
I won't spend a lot of times on how to set up a door with PCBoard.
If in doubt, I suggest you read PCBoard's manual. XFERSTAT is called
like any other ProKit door.
Sample door batch file:
@echo off
cd \pcb\doors\xferstat
xferstat xferstat.cnf c:\pcb\pcboard.sys
cd \pcb
board <== Omit this line if you are running it as a SHELL door.
************************ S P E C I A L N O T E **************************
XferStats has the unique ability to be run in TWO totally separate modes
of operation. The "normal" DOOR mode, and as a PCB14.5 "SHELL" DOOR.
On my BBS, I offer it both ways. As a normal door from the door menu,
and as a SHELL door, which can be listed as a menu command on PCB's
Main Menu.
This requires using TWO separate DOOR batch files (see XFERSTAT & XF)
and TWO separate .CNF files (see XFERSTAT.CNF and XF.CNF).
Make TWO entires in your DOORS.LST file as follows:
XFERSTAT,,31,0,0,,0,N <=== This is "normal" DOOR.
XF,,31,0,0,,0,Y <=== This is "SHELL" DOOR.
***************************************************************************
Using XFERSTAT:
---------------
The user has several choices from the Main Menu:
D - List all files downloaded and contained in DOWNLOAD.TXT
U - List all files uploaded and contained in DOWNLOAD.TXT
A - List all files (both D & U) tranferred and contained in DOWNLOAD.TXT
C - Create a list of All files transferred and D/L the list.
(Not available when running in SHELL mode !!!)
Y - List their personal statistics.
F - File Stats. See the stats on a particuliar file.
If the caller's security matches or is greater than the level listed
in the XFERSTAT.CNF file, they will also have available the S option.
Selecting this will allow searching for a text match in either the
USER or FILENAME fields.
If you are running XferStats in SHELL mode, you may enter a filename
to see the stats on right from PCBoard's command line.
I would suggest that you name the door batch file to something
like XF if you plan to run XferStats in seamless mode.
Then the caller can just type " XF anyfile.zip " and they will go
directly into File Stats Mode.
Registration:
-------------
XFERSTAT is released as ShareWare and may be used freely for a period
not to exceed 90 days. After the 90 day period, you must either discon-
tinue using the software or register it. The shareware version is fully
functional, with the exception of the [UNREGISTERED] messages and the
delay upon exiting the door.
If you like the program, and wish to register it, send $15.00 (US) in
the form of Check or Money Order to the address provided below:
Keith Cochran
P.O. Box 950
Rehoboth Beach, DE
19971
U.S.A.
You will then be issued a registration number that will display your
BBS name on the opening and closing screens and will disable the delay
when exiting the door.
The registration number will work with ALL future releases of XFERSTAT.
Be sure to include a return address and specify EXACTLY how you will
spell your BBS name in the .CNF file.
^^^
Disclaimer:
-----------
I make no warranty of any kind, express or implied, including without
limitation, any warranties of merchantability and/or fitness for a
particular purpose. I shall not be liable for any damages, whether
direct, indirect, special or consequential arising from a failure of
this program to operate in the manner desired by the user. I shall not
be liable for any damage to data or property which may be caused
directly or indirectly by the use of this program.
IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.
PCBoard is a registered trademark of Clark Development Company.
InstaReg is copyrighted by Don Cheeks and Lana Fox.
Turbo Pascal 6.0 is copyrighted by Borland International.
Beta Testers:
-------------
Special thanks to the following people who were a great help
with testing XferStats.
Butch Dunn The No*Name BBS (302) 477-1230 HST 14.4K
Greg Parsons Paradise Cove BBS (302) 436-4780 HST 14.4K
Be sure to check out these 2 bbs's, as both are first class systems.
Support:
--------
The latest version of XferStats can always be found on Paradox BBS.
The numbers are (302) 645-7264 & 645-2658. Additional time/privileges
for visiting SysOps. Node 1 is equipped with a USR Dual Standard.
I also may be reached via SaltAir's DOORS conference, via RIME's
DOORS, SYSOPS or COMMON conferences, ILink's SYSOPS conference,
MetroLink's SYSOPS conference. Node ID for RIME and MetroLink
is ->PARADOX
Comments, ideas, or suggestions are always welcome.